Copyright: Copyright 1995 Blue Sky Software Corporation
Citation: Copyright 1995 Blue Sky Software Corporation


Overview of Contents Tab Composer

Welcome to Blue Sky Software’s Contents Tab Composer. This tool makes it easy for you to create one of the key components of Windows 95/Windows NT Help systems.

One of the main new features of Windows 95/Windows NT Help is the Contents Tab. The Contents Tab is displayed as part of the Help Topics window when a Windows 95/Windows NT Help system is opened. The Contents Tab displays a list of the topics in the Help system, organized by category. The Contents Tab Composer allows you to graphically design and configure a Contents Tab for your Help system.

With the Contents Tab Composer, you visually design your Contents tab, rather than having to remember and type Topic IDs. The Contents Tab Composer then takes care of generating the new Help system source files for you—including a new source file, the CNT file, which contains the information for displaying the Contents tab.

The Contents Tab Composer also checks all of your Help system source code and updates it for the Windows 95/Windows NT Help compiler. And, you call the Help compiler right from within the Contents Tab Composer.

See Also

Key Features of the Contents Tab Composer


Key features of the Contents Tab Composer

Checks and Updates Your Help Source For Windows 95/Windows NT Support

•	Checks and updates your WinHelp project settings (.HPJ file) for Windows 95/Windows NT support.

•	Gives you comprehensive easy to use graphical access to the WinHelp project settings
(.HPJ file).

Adds Contents Tabs to Help Systems—the Easy Way

•	Automatically reads in all topics from the Help source.

•	Add All option provides one-click method for including all of your Help topics in the Contents Tab.

•	Easy drag and drop editing to add and organize books and topic pages in your Contents Tab.

•	Preview Help topics as you design the Contents Tab. With the Contents Tab Composer, there is no need to wonder whether you have selected the correct topic.

•	You can associate macros, programs, program data files and help topic text with a Help topic page.

•	Allows you to specify the window in which your topic will be displayed.

•	Adds a standard Windows 95/Windows NT secondary window to your project.

Generates .CNT Files For You

•	Generates the precisely formatted .CNT file for you.

•	Allows you to edit existing .CNT files.

Allows You to Add Buttons to Main and Secondary Windows

•	Easily add new Windows 95/Windows NT style buttons to your main Help window.

•	Easily add buttons to your secondary Help windows.

Allows You To Link Help Files

•	You can specify multiple .HLP files to be included in the Contents Tab.

Allows You to Create a Combined Index

•	You can specify multiple .HLP files to be included in the Index Tab.

•	Allows you to generate index files for full-text search.

Runs the Microsoft Windows 95/Windows NT Help Compiler

•	Runs the Microsoft Windows 95/Windows NT Help compiler (HCW.EXE) directly from within the Contents Tab Composer.

•	Allows you to select the type of compression, if any, to minimize the Help system size.


Opening Help projects

1.	Click Add Contents from the Tools menu.

2.	On the File menu, click Open.

3.	In the Look In field, select the folder for the file.

4.	In the Files of Type field, choose the type of file to be opened:

5.	Double-click the name of the file to be opened.

Tips

•	If you open an .HPJ file, a contents (.CNT) file with the same root name is created (if it does not already exist).

•	The File menu lists that last four projects opened recently—to open one of these projects, just click on its name.


Saving Help projects

•	On the File menu, click Save.
The Contents Tab Composer saves the contents information to the .CNT file and the project properties to the .HPJ file.

Note

•	You should save and exit the Contents Tab Composer after each session. If you add topics and simply minimize the Contents Tab Composer, these topics will not show up in the Contents tab window when you maximize the screen again.


Compiling Help projects

•	Click [image]. The Contents Tab Composer calls the Windows 95/Windows NT Help compiler (HCW.EXE) to generate the .HLP file from the information in the .HPJ and .CNT files.

Tip

•	Depending on your compiler settings you may need to close the HCW window to return to Contents Tab Composer.


Running Help projects

•	Click [image].

Tips

•	The Help system that displays is the most recently compiled version. Therefore, you should compile the project before running it.

•	You can use Help Author Mode to test your project. When you run a Help system in Help Author Mode, the topic number displays in the title bar, and you can see the jump text. To turn on Help Author Mode, on the the Contents Tab Composer Project menu, click WinHelp Mode, then click Help Author.


Exiting Contents Tab Composer
Exiting the Contents Tab Composer

•	On the File menu, click Exit.
The Contents Tab Composer closes the current project, prompting you to save any unsaved changes.

Note

•	You should save and exit the Contents Tab Composer after each session. If you add topics and simply minimize the Contents Tab Composer, these topics will not show up in the Contents tab window when you maximize the screen again.


Adding books

1.	Click Add Contents from the Tools menu.

2.	Position the cursor at the point where the book is to be inserted. (The book will be inserted above the selected item.)

3.	If you want to use a title from an existing topic, click the topic in the Topics list.

4.	Click [image].

5.	Enter the name of the book as you want it to appear on the Contents Tab.

6.	Click OK.

Tips

•	If you selected a title in the Topics list, the Book Name is filled in using the topic title. You can change it or leave it as is.

•	If you have a topic page set up in the Contents Tab Composer, you can convert it to a book in one step: in the Contents Tab Composer, right-click the topic page, then click Convert to Book.


Editing books

1.	Click Add Contents from the Tools menu.

2.	Click the book title to select it.

3.	Click the book title again to activate Rename mode.
A box appears around the name and the text is highlighted.

4.	Change the text as needed.

Tips

•	You can also edit this title by clicking on the book and then clicking [image].
In the Edit Book dialog, change the text and then click OK.


Deleting books

1.	In the Contents Tab Composer, right-click the book to be deleted.

2.	Click Delete.

Tips

•	You can delete any book from the Contents Tab.

•	This option deletes the book’s contents as well—this includes ALL items, both books and topic pages, that are below the book in the hierarchy.

•	You can undo this operation.


Adding topic pages

1.	In the Contents Tab Composer, position the cursor at the point where the topic page is to be inserted. (The topic page will be inserted below the selected item.)

2.	Click [image].

3.	Enter the name of the page as you want it to appear on the Contents Tab.

4.	If you want the page to be a jump to a topic, verify Display Topic is selected and then select the topic from the list. (You can define other types of jumps for a page - see Tips).

5.	Click OK.

Tips

•	Use Quick Topic Page or drag and drop if you are adding a basic topic page and don't need to specify any settings in the New Topic Page dialog.

•	To preview topic text click Preview.

•	You can list the available topics by Title or by Topic ID. Your choices include: Show All by Title, Show All by Topic ID, Show Unused by Title, and Show Unused by Topic ID.

•	You can select the window in which the topic text will display (all windows defined in the WINDOWS section of the .HPJ file are listed in the In Window combobox).

•	If you want the page to perform an action other than jumping to a topic, click Advanced to display additional options.

•	To insert a “custom option,” click Custom Page and then enter the text to be displayed in the Contents Tab.

•	You can enter anything allowed for a contents page, including a Topic ID from a different Help system or a special command.

•	Any entered text is inserted directly into the CNT file.

•	There is no validation performed on this text - Invalid data could cause errors when the help file is run.

•	To run a macro, click Run Macro and then enter the macro name and parameters. You can call multiple macros by placing semi-colons between the calls.

•	To run a file or program, click Run File/Program and then enter or select (using Browse) the file or program name. To include the path in the program call, click Full Path. Note that the Contents Tab Composer converts the program call to a macro that can be processed by WinHelp—next time you view this section the program call will be located in the Macro field.


Adding topic pages using drag and drop

1.	In the Topics list, click the topic to be added.

2.	While holding down the mouse button, drag the item to the correct position in the Contents Tab Composer.

3.	Release the mouse button.

Tips

•	Drag and drop bypasses the New Topic Page dialog.

•	An arrow and underline appear in the position where the topic page will be placed.

•	When you use drag and drop to add a topic page, the topic page is added with the following settings. If you want to change any of these settings after the topic page has been added, you can edit the topic page.

•	The topic page is automatically defined as a jump to the topic.

•	The topic title is used as the topic page title.

•	The topic text will display in the default Help window (not a secondary window).


Quick Topic page

1.	In the Contents Tab Composer, position the cursor at the point where the topic page is to be inserted. (The topic page will be inserted below the selected item.)

2.	In the Topics list, right-click the Help topic title.

3.	Click Quick Topic Page.

Tips

•	Quick Topic Page bypasses the New Topic Page dialog.

•	When you use Quick Topic Page to add a topic page, the topic page is added with the following settings. If you want to change any of these settings after the topic page has been added, you can edit the topic page.

•	The topic page is automatically defined as a jump to the topic.

•	The topic title is used as the topic page title.

•	The topic text will display in the default Help window (not a secondary window).


Previewing topic text

•	In the Topics list, right-click the topic title and then click Preview Topic.

OR

•	In the Contents Tab Composer, right-click the topic page and then click Preview.

Tips

•	You can also access the Preview feature while adding or editing a topic page. Just click Preview in the New/Edit Topic Page dialog.

•	When you preview a topic that is set to display in a secondary window, the secondary window only displays after the Help system has been compiled in Windows 95/Windows NT Help—before compilation, the topic text displays in the main Help window.


Secondary windows

Although secondary windows were available in previous WinHelp versions, they have been enhanced for Windows 95/Windows NT Help, and are becoming much more common in Help system designs. There are some things to keep in mind if you use secondary windows:

•	The Contents Tab Composer includes a secondary window, already set up for Windows 95/Windows NT Help. The name of the window is “(w95sec)” and it is available in the selection list in the Add/Edit Topic Page dialog. This window uses the title setting in the .HPJ file as its title.

•	If you use secondary windows, set a default main window in .CNT setup. (Click Setup on the Contents menu). See Contents Setup for further details on .CNT settings.

•	You can now add buttons to secondary windows. One button you should always include is Help Topics, allowing the user to return to the Help Topics window from your secondary window. Use the secondary window included with the Contents Tab Composer or use the Contents Tab Composer to add buttons to your existing secondary windows (see Adding Buttons to Windows).

•	When you preview a topic that is set to display in a secondary window, the secondary window only displays after the Help system has been compiled in Windows 95/Windows NT Help—before compilation, the topic text displays in the main Help window.


Adding buttons to windows

1.	On the Project menu, click Window Buttons.

2.	From the Window list, select the window.

3.	Select the applicable buttons.

4.	Click Apply.

5.	Repeat steps 2-4 for each window.

6.	Click OK.

Tips

•	The Contents Tab Composer allows you to add buttons to your existing secondary windows and to the Main Help window.

•	Microsoft recommends the following buttons:

Main Window	Secondary Windows
Help Topics Back Print Browse	Help Topics Back Options
•	The Window list includes all windows that currently exist in your .HPJ file. The Contents Tab Composer automatically adds the secondary window (w95sec) with the recommended buttons set up.

•	Click Standard Windows 95/Windows NT Buttons to select the recommended Windows 95/Windows NT Help buttons as listed above. This setting changes depending on the type of window selected (main or secondary).

•	Click Default Windows 3.x Buttons to select the buttons used in WinHelp 3.x (Contents, Index, Print, Back). Note that this setting only affects the Main window.


Editing topic pages

1.	In the Contents Tab Composer, click the topic page to be edited.

2.	Click [image].

3.	Change the options as necessary. See Adding a Topic Page for details on the available options.

4.	Click OK.

Tips

•	To preview topic text click Preview.

•	If you only need to change the title of the topic page, just click on the topic page title to select it (in the Contents Tab Composer), click again to activate Rename mode, and edit the text.


Deleting topic pages

1.	In the Contents Tab Composer, right-click the topic page to be deleted.

2.	Click Delete.

Tips

•	You can delete any topic page from the Contents Tab.

•	You can undo this operation.


Adding all topics

•	Click [image].

Tips

•	A book is created for each .RTF file in the project. The file name displays as the book title in the Contents Tab.

•	Within the book, a topic page is created for each Help topic in the .RTF file. The topic title displays as the descriptive text in the Contents Tab.

•	The books and topic pages are added to the end of the current Contents Tab.

•	You can change the position of the books and topic pages. See Positioning Books and Topic Pages for details.


Positioning books and pages

Rules

Using Drag and Drop

Using the Arrow Buttons

Using Cut, Copy and Paste


Positioning rules

There are some basic rules that dictate how a book or topic page will be placed when you move it to a new location:

•	Topic pages must precede books on the same level in the hierarchy. If you position a topic page below a book it is placed within the book.

•	A book must contain at least one topic page. If a book contains no topic pages, it will not display in the Contents Tab of your compiled Help system.

•	When a book is moved, all books and topic pages within it are moved also.

•	Included .CNT files must be located on the root level of the hierarchy (for details on including .CNT files, see Including Another Contents File.


Positioning using drag and drop

1.	Click the book or topic page.

2.	While holding down the mouse button, drag the item to its new position.

3.	Release the mouse button.

Tips

•	If you are moving a book:
If the item is to be placed WITHIN another book, a rectangle appears around the book that will contain the item. If the item is to be placed BELOW another book or topic page on the same level in the hierarchy, an arrow and underline appear in the position where the item will be placed.

•	If you are moving a topic page:
An arrow and underline appear in the position where the topic page will be placed.


Positioning using the arrow buttons

Use the arrow buttons to move the selected book or topic page to a different position in the hierarchy.

	Use the up arrow to move a book or topic page up one position on the same level of the hierarchy (an item on level two stays on level two if possible).
	• If the book or topic page is the first in a book, it is moved up above the book. • If it does not make sense to place the book or topic page in the above position, it may move up one level (such as from level three to level two).
	Use the down arrow to move a book or topic page down one position, in the hierarchy.
	• If the book or topic page is the last in a book, it is moved down below the book and becomes the first book or topic page in the next book.
	Use the left arrow to move a book up one level in the hierarchy, such as from level 3 to level 2.
	Use the right arrow to move a book down one level in the hierarchy, such as from level 2 to level 3.


Positioning using cut, copy, and paste

Use the copy, cut, and paste buttons to cut or copy a book or topic page and then paste it in a new position.

	Cut the currently selected book or topic page to the Windows Clipboard.
	Copy the currently selected book or topic page to the Windows Clipboard.
	Paste the current Windows Clipboard contents into the Contents Tab Composer. When you paste, the new item is placed below the currently selected item, on the same level. For example, if you select a book and then paste a book, the pasted book is located below the selected book, on the same level of the hierarchy—not within the selected book.


Clearing all topics

1.	On the Edit menu, click Clear All.

2.	Click OK to confirm (see tip below).

Tip

•	To disable the confirmation message, click Disable this message. With the Disable option selected, any time you click Clear All, the Contents Tab Composer implements the command without asking you to confirm.


Creating a Master Contents file

1.	On the File menu, click Create Master CNT.

2.	Enter a File Name for the .CNT file, or select one from the list. If you select a file name, this .CNT file becomes a “master.”

3.	Click Open. The Contents Tab Composer asks if you want to set the Default Help File.

4.	Click Cancel.
If you do not click Cancel, the master .CNT file will not function properly.

5.	Include Contents files to create your Contents Tab.

Tip

•	Do NOT create a .HLP file for this .CNT file (do not add a :Base statement to your .CNT file).


Including another Contents file

1.	In the Contents Tab Composer, position the cursor at the point where the file is to be inserted.

2.	On the Contents menu, click Add External CNT File.

3.	Enter or select (using Browse) the Contents file name to be included. If the path is needed, enter it with the file name.

4.	Click OK.

Tips

•	When you include another .CNT file, an Include statement is added to your .CNT file.

•	To edit the text of the included Contents file, open the file as a separate project in the Contents Tab Composer.

•	Contents files are always included at the root level of the hierarchy.


Editing an Include statement

1.	In the Contents Tab Composer, select the statement to be edited.

2.	On the Contents menu, click Edit External CNT File.

3.	Enter or select (using Browse) the Contents file name to be included. If the path is needed, enter it with the file name.

4.	Click OK.

Tip

•	To edit the text of an included Contents file, open the file as a separate project in the Contents Tab Composer.


Contents setup

1.	On the Contents menu, click Setup.

2.	Enter the title for the Help Topics window. This option corresponds to the :Title setting in the .CNT file.

3.	Select a default window. This used to display all topics where a window is not specified as part of the topic jump. Windows that are defined in the WINDOWS section of the .HPJ file are available to be selected as the default.

4.	Select a default Help file. This is the main help file for the project. This option corresponds to the :Base setting in the .CNT file.

5.	Click OK.

Tips

•	If you use secondary windows in your Help system, be sure to select a default window here (do not use “standard”). This enables WinHelp to return to the default window after displaying a secondary window.

•	If you want to create an index comprised of several Help files, click Index. See Creating a Multiple File Index for further details.

•	If you want to create search lists comprised of several Help files, click Link Files. See Setting Up Link Files for further details.


Creating a multiple file Index

1.	On the Contents menu, click Setup.

2.	Click Index.

3.	For each Help file to be included:

•	Enter the Index title.
This title will be listed in the Current Index combo box of the Index Tab.

•	Enter or select (using Browse) the Help file name to be included in the index. If the path is needed, enter it with the file name.

•	Click Add.
The index name is added to the list of Help files to be included in the combined index.

4.	To replace an existing entry in the list of Help files, click the entry, enter a title and Help file name, and click Replace.

5.	To remove an entry from the list of Help files, click the entry then click Delete.

6.	Click OK to save your changes and return to Contents Setup.

Note

•	For information on the other Contents Setup options, see Contents Setup.


Setting up Link files

1.	On the Contents menu, click Setup.

2.	Click Link Files.

3.	For each Help file to be included:

•	Enter or select (using Browse) the Help file name to be included.
If the path is needed, enter it with the file name.

•	Click Add.
The Help file is added to the list of Help files to be included in the combined search.

4.	To replace an existing entry in the list of Help files, click the entry, select the Help file name, and click Replace.

5.	To remove an entry from the list of Help files, click the entry then click Delete.

6.	Click OK to save your changes and return to Contents Setup.

Note

•	For information on the other Contents Setup options, see Contents Setup.


Project setup - General

1.	On the Project menu, click Properties.

2.	Click General.

3.	Select a default topic.
This option corresponds to the CONTENTS setting in the [OPTIONS] section of the .HPJ file.

4.	Enter the copyright statement to display in the About box for the Help system.
This option corresponds to the COPYRIGHT setting in the [OPTIONS] section of the .HPJ file.

5.	Enter the copyright statement to be included in the Help text.
This setting appends a copyright notice to the end of any information that is copied or printed from the Help file. This option corresponds to the CITATION setting in the [OPTIONS] section of the .HPJ file.

Tips

•	The default Help topic displays if a topic is not specified by the Help system, or if WinHelp cannot find a specified topic.

•	When selecting the default Help topic, you can list the available topics by Title or by Topic ID. Select Show by Title to list the topics by Title; deselect this option to list the topics by Topic ID.

•	The Build filename is the name of the compiled Help (.HLP) file. This option corresponds to the .HLP setting in the [OPTIONS] section of the .HPJ file.

•	When entering a copyright statement you can click the Copyright button to insert a copyright (©) symbol.


Project setup - Compiler

1.	On the Project menu, click Properties.

2.	Click Compiler.

3.	Select the compilation options.

4.	Select the type of compression to be used.
This option corresponds to the COMPRESS setting in the [OPTIONS] section of the .HPJ file.

•	Select from a list of the most commonly used settings.
(The Compiler chooses the type of compression in order to achieve the specified result.)

OR

•	Click Custom to specify the type of compression to be used.

5.	Enter or select (using Browse) paths and file names for the Help system.
Include the path if the file is located in a different folder than the .HLP file.

6.	Select the Build expression to be included when your Help system is compiled. Build expressions allow you to include specific topics. This is only available if the .RTF file has build tags assigned to the topics. This option corresponds to the BUILD setting in the [OPTIONS] section of the .HPJ file.


Compilation options

•	Report on Progress
Displays status messages on the screen during the compilation. This option corresponds to the REPORT setting in the [OPTIONS] section of the .HPJ file.

•	Display Compiler Notes
Shows informational notes during the compile. Notes describe events that will not prevent the Help compiler from running or affect the integrity of compiled help file. Displaying notes slows down the compiler. This option corresponds to the NOTES setting in the [OPTIONS] section of the .HPJ file.

•	Optimize for CD-ROM
Optimize the Help file to run from CD-ROM. This can enable the user’s system to read your Help file faster, but it also creates a larger Help file. This option corresponds to the OPTCDROM setting in the [OPTIONS] section of the HPJ file.

•	Display Compiler Window
The WinHelp compiler window displays while the Help system is being compiled. If you select this option, you can also choose to close the window when the compilation has finished.

•	Auto Close Compiler Window After Compile
Automatically close HCW and return to the Contents Tab Composer after compiling.


Custom compression

Phrase
The compiler creates a PH file. Reusing this PH file speeds up the compression process if the text has not changed significantly since the last compression. However, to get maximum compression you must create the PH file each time you compile the Help file. Phrase compression is recommended for files less than 100K.

Hall
Larger Help files get better compression ratios using this method. Hall compression is recommended for files larger than 100K, and is required if you are generating the full text search (FTS) file for your users. See Advanced settings for details on generating the FTS file.

Zeck
Combine this compression with Hall compression for the fastest choice. You can also use Zeck compression on its own; this reduces the compile time but increases Help file size.


File names

HCW.EXE
WinHelp Compiler.

HCRTF.EXE
Used by HCW.EXE to compile a Help system.

CNT file
Defines the appearance of the Contents topic in Windows 95/Windows NT Help. This option corresponds to the CNT setting in the [OPTIONS] section of the .HPJ file.

TMP folder
The folder containing temporary files created by the Help compiler. If this option is not set the compiler uses the folder specified by the local TEMP environment variable. This option corresponds to the TMPDIR setting in the [OPTIONS] section of the .HPJ file.

Error Log file
Contains a record of the compilation, including error messages and the number of topics. This option corresponds to the ERRORLOG setting in the [OPTIONS] section of the .HPJ file.


Project setup - Graphics settings

1.	Click Properties on the Project menu.

2.	Click Graphics.

3.	Use Browse to select folders that contain the graphics for your Help system.

4.	To remove an entry from the list, click the entry, then click Remove.

Tips

•	If you store graphics in folders other than the one in which your .HPJ is stored, specify the folders here so that the Help compiler can find the graphics.

•	This option corresponds to the BMROOT setting in the [OPTIONS] section of the .HPJ file.


Project setup - Data settings

1.	Click Properties on the Project menu.

2.	Click Data.

3.	Use Browse to select files to be stored as baggage.

4.	To remove an entry from the list, click the entry, then click Remove.

Tips

•	Use this setting to define files to be stored within the .HLP file’s internal system. This allows WinHelp to access the files more efficiently.

•	WinHelp does not limit the number of files that you can define, however, adding too many files will waste disk space and decrease performance when building and displaying the file.

•	This option corresponds to the [BAGGAGE] section of the .HPJ file.


Project setup - Alias settings

1.	Click Properties on the Project menu.

2.	Click Aliases.

3.	For each alias to be assigned:

•	Choose an ID from the Map file (Imported Mapfile ID).
You can click Browse to select a different Map (.H or .HH) file.

•	Choose an ID from the current Help system (Help System Topic ID).

•	Click Add.
As aliases are assigned the topics are removed from the Imported Mapfile list.

4.	To remove an entry from the list of Help System Aliases, click the entry, then click Delete.

Tips

•	Aliases allow you to associate a Help Topic ID with another ID. This can be useful when you have Topic IDs that have become invalid or have been changed.

•	This option corresponds to the [ALIASES] section of the .HPJ file.


Project setup - Map settings

1.	Click Properties on the Project menu.

2.	Click Map Files.

3.	Use Browse to select the files that contain the context mappings for your Help system.

4.	To remove an entry from the list, click the entry then click Remove.

Tips

•	The Map Files Tab in Project Properties specifies the files that contain the map numbers for context-sensitive help.

•	This option corresponds to the [MAP] section of the .HPJ file.


Project setup - Advanced settings

1.	Click Properties on the Project menu.

2.	Click Advanced.

3.	Select Generate Full Text Search Index File if you want WinHelp to generate the file used in full text searches.

•	In the Options list, choose the type of searching to be used in the Find Tab.

•	Select Include Topics Without Titles if you want untitled topics to be included in the Find Tab index.

4.	Select Sort Using Language if you want to specify the language to be used for sorting the index.

•	Select the language which conventions should be used for sorting the index.

•	If you want the index to be sorted without regard to non-spacing marks and/or symbols, choose the corresponding option(s).

5.	If you want to specify the characters used to separate index entries into levels, choose the characters in the Index Separating Characters field.

6.	Select the Font settings.

•	Select a default character set. This option corresponds to the CHARSET option in the .HPJ file.

•	If you want to change the default font, click Change, select the font, style, and size, and click OK. The default font specifies the font that WinHelp uses for text in the Contents and Index Tabs and in the Topics Found dialog box.

Tips

•	If the Find file is not generated during the compile, it is generated when the user chooses the Find Tab in the Help system.

•	To disable the Find Tab for your Help system, enter the command :Nofind in the .CNT file.

•	If you do not enter Index Separating Characters the default comma, semi-colon and colon values are used.

•	The Index Separating Characters option corresponds to the INDEX_SEPARATORS setting in the [OPTIONS] section of the .HPJ file.

•	The Generate Full Text Search Index File option corresponds to the FTS setting in the [OPTIONS] section of the .HPJ file.

•	The Sort Using Language option corresponds to the LCID setting in the [OPTIONS] section of the .HPJ file.

•	The Change Font option corresponds to the [DEFFONT] option in the .HPJ file.


Error log browse

Use this dialog to select the log file for the compilation. This file stores all of the messages generated by the compiler—you can use it as a reference when you are cleaning up the errors in your Help file.

To specify the log file:

•	In the File Name field, type in the full path and file name, then click Open.

OR

•	In the Look In field, choose the folder for the error log.

•	In the Files of Type field, choose the type of file to be used for the error log:
*.ERR OR *.LOG

•	Double-click the file name.


Contents browse

Use this dialog to select the contents file to be displayed when the Contents Tab is selected in your Help system.

To specify the contents file:

•	In the File Name field, type in the full path and file name, then click Open.

OR

•	In the Look In field, choose the folder for the contents file.

•	Double-click the file name.


Data files browse

Use this dialog to select files that will be stored as baggage within the compiled .HLP file.

To select a data file:

•	In the File Name field, type in the full path and file name, then click Open.

OR

•	In the Look In field, choose the folder for the data file.

•	Double-click the file name.


Map files browse

Use this dialog to select Map files to be included in your Help project.

To select a map file:

•	In the File Name field, type in the full path and file name, then click Open.

OR

•	In the Look In field, choose the folder for the map file.
In the Files of Type field, choose the type of map file to be included:
*.HH OR *.H

•	Double-click the file name.


Find WinHelp Compiler

Use this dialog to specify the path and filename of the WinHelp compiler.

To select the compiler path:

•	In the File Name field, type in the full path and file name, then click Open.

OR

•	In the Look In field, choose the folder for the data file.

•	Double-click the file name.


Add Page Run Program browse

Use this dialog to select the program to run when the user clicks the topic page.

•	In the File Name field, type in the full path and file name, then click Open.

R

•	In the Look In field, choose the folder for the program.

•	In the Files of Type field, choose the type of program file to be run:
*.EXE OR *.COM

•	Double-click the file name.


Edit Page Run Program browse

Use this dialog to change the name of the program to run when the user clicks the topic page.

•	In the File Name field, type in the full path and file name, then click Open.

O

•	In the Look In field, choose the folder for the program.

•	In the Files of Type field, choose the type of program file to be run:
*.EXE OR *.COM

•	Double-click the file name.


Add Page Run File browse

Use this dialog to select the file to run when the user clicks the topic page.

1.	In the Look In field, choose the folder for the file.

2.	In the Files of Type field, choose the type of file to be run: *.EXE or *.COM

3.	Double-click the file name.


Edit Page Run File browse

Use this dialog to change the name of the file to run when the user clicks the topic page.

1.	In the Look In field, choose the folder for the file.

2.	In the Files of Type field, choose the type of file to be run: *.EXE OR *.COM

3.	Double-click the file name.


Add external CNT file browse

Use this dialog to select an external Contents (.CNT) file to include in the Contents tab.

To select a contents file:

•	In the File Name field, type in the full path and file name, then click Open.

R

•	In the Look In field, choose the folder for the contents file.

•	Double-click the file name.


Edit external CNT file browse

Use this dialog to change the name of the Contents (.CNT) file specified in an Include statement.

To select a contents file:

•	In the File Name field, type in the full path and file name, then click Open.

R

•	In the Look In field, choose the folder for the contents file.

•	Double-click the file name.


Combined Index files browse

Use this dialog to select Help files to be included in the combined index.

To select a Help file:

•	In the File Name field, type in the full path and file name, then click Open.

R

•	In the Look In field, choose the folder for the Help file.

•	Double-click the file name.


Link files browse

Use this dialog to select Help files to be included in Alink/Klink searches.

To select a Help file:

•	In the File Name field, type in the full path and file name, then click Open.

R

•	In the Look In field, choose the folder for the Help file.

•	Double-click the file name.


Compile Temp folder browse

Use this dialog to select the drive and folder to hold the temporary files generated by the WinHelp compiler.

To select a folder:

1.	Click the drives and folders in the folder tree, working through the folder structure until you reach the folder you want to use.

2.	Click the folder.

3.	Click OK.


Graphics files browse

Use this dialog to select a drive and folder that contains graphics to be used in your Help project.

To select a folder:

1.	Click the drives and folders in the directory tree, working through the directory structure until you reach the folder you want to use.

2.	Click the folder.

3.	Click OK.


Book

In the Windows 95/Windows NT Help Contents Tab, books represent groups of topics. Books can contain topic pages (jumps to topics) and they can also contain other books. When a user clicks a book the contents of that book display and are available for selection.


Topic page

Topic pages are the individual units of information that are contained within books. A topic page represents an action—it can be a jump to a Help topic, or it can execute a macro or a program. When a user clicks a page the action is performed.


Contents file

In your Contents Tab, you can include jumps to other Help systems’ Contents files. To do this, you include the Contents (.CNT) file for the other Help system in your Contents Tab. When the user clicks the file, the new Contents Tab displays. When a Contents file is called from within your Contents file, an Include statement is added to your .CNT file.